home *** CD-ROM | disk | FTP | other *** search
/ Amiga CD-ROM Collection / Amiga CD-ROM Collection - Auge 4000 and Cactus and Demo Util.iso / cactus / 18 / wicon.doc < prev    next >
Text File  |  1988-06-14  |  14KB  |  314 lines
  1.    CACTUScactusCACTUScactusCACTUScactusCACTUScactusCACTUScactusCACTUScactus
  2.    U                                                                      U
  3.    S                               WICON                                  S
  4.    E                               *****                                  E
  5.    R                   Übersetzt 10/88 von C.A.C.T.U.S.                   R
  6.    S                                                                      S
  7.    cactusCACTUScactusCACTUScactusCACTUScactusCACTUScactusCACTUScactusCACTUS
  8.  
  9.  
  10. WICON(1)                    BENUTZERBEFEHLE                WICON(1)
  11.  
  12.  
  13.  
  14. NAME
  15.      wicon - Window Iconifier
  16.  
  17. EINGABEFORMAT
  18.      wicon [-[!]a] [-b [/|*]boxes] [-c [+|-]chars] [-[!]d] [-[!]f]
  19.       [-[!]i] [-l lines ][-p [+|-]priority] [-[!]q] [-[!]r]
  20.       [-[!]s] [-[!]t] [-[!]w] [-W console] [-[!]&]
  21.      wicon ?     ; Argumente und Voreinstellungen werden aufgelistet
  22.      wicon       ; wicon wieder entfernen
  23.  
  24. ARBEITSWEISE
  25.      Wicon bezieht sich immer nur auf einen Bildschirm. Solange nicht
  26.      das Argument -f (first screen) angegeben wird, wirkt Wicon auf den
  27.      Workbench-Bildschirm. Ein aktives Fenster kann durch Anklicken mit
  28.      der rechten Maustaste zum Icon umgewandelt werden. Die genaue
  29.      Vorgehensweise hängt von der jeweiligen Wicon-Version ab. Im Moment
  30.      darf man zwischen niederdrücken und loslassen der Maustaste die Maus
  31.      nicht bewegen. Das gleiche gilt, wenn DoubleClickTime(3), z.B.
  32.      von den Preferences aus, eingestellt wurde.
  33.  
  34.      Einge Fenster können nicht zum Icon gewandelt werden. Die Workbench-
  35.      Fenster werden vom loadwb-Programm kontrolliert. Aus programmtech-
  36.      nischer Sicht handelt es sich um die Fenster, bei denen gilt
  37.      (Window->Flags | WBENCHWINDOW). Das dient dazu, ein Fenster, das
  38.      schon geöffnet wurde, bei zweimaligem Anklicken des Icons in den
  39.      Vordergrund zu bringen. Diese Fenster zu Icons zu wandeln, böte
  40.      natürlich viele Vorteile für Floppybesitzer mit vollen Inhalts-
  41.      verzeichnissen. Um diese Fenster umwandeln zu können, mußt Du nur
  42.      "WBWINDOWS=TRUE" oder "-w" als Argument beim Wicon-Aufruf angeben.
  43.  
  44.      Nach viel Herumprobieren merkte ich, daß man Fenster am einfachsten
  45.      mit einem Klick der rechten Maustaste umwandeln könnte.
  46.      Das verursacht einige Probleme mit Programmen, die ebenfalls auf ein
  47.      Klicken der rechten Maustaste warten (RMB event):
  48.  
  49.     1> Um ein Menü zu erreichen
  50.     2> Um eine Bildschirmausgabe anzuhalten
  51.     3> Um etwas aus der Bildschirmanzeige auszuwählen
  52.  
  53.      Die Lösung dazu bestand darin, daß Wicon nur reagiert, wenn zwischen
  54.      Niederdrücken und loslassen der rechten Maustaste die Maus nicht
  55.      bewegt wird. Das löst die Probleme mit 1) und 2), weil man nur die
  56.      Maus ein wenig bewegt und sich sonst keine Sorgen zu machen braucht.
  57.  
  58.      Leider ist das äußerst unpraktisch bei Programmen wie AMIGAP und
  59.      DME, bei denen gerade ein kurzes Klicken mit der rechten Maustaste
  60.      die Bedienung zum Vergnügen macht. Ist also RMBTRAP=FALSE (das ist
  61.      die Voreinstellung), dann können Fenster, die auf einen Druck der
  62.      rechten Maustaste warten (z.B. Window->IDCMPFlags | RMBTRAP), nicht
  63.      umgewandelt werden. Um diese Fenster umwandeln zu können, gibst Du
  64.      als argument an "RMBTRAP=TRUE" oder "-r".
  65.  
  66.      Anmerkung: Der Klick mit der rechten Maustaste wird nur dann an
  67.      Intuition weitergegeben, wenn entweder DoubleClickTime(3) angeklickt
  68.      wird oder die Maus dabei bewegt wird. Bewege deshalb die Maus einmal
  69.      kurz, wenn Du Menüs mit der rechten Maustaste erreichen möchtest.
  70.  
  71.      Wicon wird zur Zeit gleichzeitig mit MacWin aufgerufen. Dieses
  72.      Programm erzeugt bei Öffnen und Schließen eines Fensters den
  73.      Gummiband-Effekt, d.h. es wird ein sich erweiternder bzw. verengender
  74.      Rahmen erzeugt, der sich vom Icon in Richtung zu öffnendes Fenster
  75.      bewegt bzw. umgekehrt. DSas Programm wirkt auf alle Fenster. Zum
  76.      Ausschalten dieses Effektes gibst Du entweder im INFO-Fenster der
  77.      Workbench "BOXES=0" ein, oder Du benutzt beim Aufruf von Wicon das
  78.      Argument -b0. Dieser Effekt kann auch durch Eingabe von "-!a" oder
  79.      "ALLSCREENS=FALSE" auf den Wicon-Bildschirm beschränkt werden..
  80.  
  81.      Alle Möglichkeiten der Kommandozeile können auch von der Workbench
  82.      aus mit dem INFO-Fenster genutzt werden. Die Argumente werden einfach
  83.      in der Zeile "ToolTypes" eingegeben. Zur ausgabe von Fehlermeldungen
  84.      kann auch das Aztec C-spezifische WINDOW=CON:X/Y/W/H/name  benutzt
  85.      werden. Alle Argumente können auch ausgeschrieben werden. So bewirkt
  86.      "BOXES=30" dasselbe wie "-B30".
  87.  
  88.      Die CLI-Eingabezeile akzeptiert auch z.B. folgendes:
  89.  
  90.    wicon -b 30 -p +5     ; \
  91.    wicon -b30 -p+5       ;  > 30 Rahmen, Priorität um 5 erhöhen
  92.    wicon BoxEs=30 PRI=+5 ; /
  93.    wicon -b /2           ; nur die Hälfte der eingestellten Rahmen zeichnen
  94.    wicon -b0x11          ; 17 (hexadezimal) Rahmen
  95.    wicon -b 013          ; 11 (oktal) Rahmen
  96.    wicon BOXES=\13       ; 11 (oktal) Rahmen
  97.  
  98.     Während es bei den "-" Argumenten auf Groß- oder Kleinschreibung
  99.     ankommt, sind die ausgeschriebenen Befehle nicht empfindlich.
  100.  
  101.      -& | -!&
  102.      EXECV=boolean
  103.        Wenn das den Wert TRUE liefert, dann befindet sich Wicon im Speicher.
  104.        Besonders nützlich, beim Aufruf von der Startup-Sequence aus. Der
  105.        Befehl "wicon -&" läßt die Startup-Sequence erst dann weiterabar-
  106.        beiten, wenn Wicon läuft, um nicht mit den nachfolgenden Befehlen
  107.        der Sequenz in Schwierigkeiten zu geraten. Im Grunde wird damit
  108.        dasselbe bewirkt wie durch den RUNBACK-Befehl (der sich nicht auf
  109.        dieser Diskette befindet).
  110.  
  111.      -a | -!a
  112.      ALLSCREENS=boolean
  113.        MacWindows wird auf allen anderen außer dem Wicon-Bildschirm ausge-
  114.        schaltet. Voreinstellung dafür ist FALSE (-!a).
  115.  
  116.      -b boxes
  117.      BOXES=short
  118.        Die Anzahl der rahmen; jeder Rahmen benötigt einen Zyklus bzw.
  119.        ein Bildschirm-Update. Voreinstellung ist hier 15; d.h. alle 15
  120.        fünzigstel Sekunden auf PAL-Amigas und alle 15 sechzigstel Sekunden
  121.        auf NTSC. Ist boxes=0, dann wird kein Rahmen gezeichnet.
  122.  
  123.      -c chars
  124.      CHARSACROSS=short
  125.        Die Anzahl der Buchstaben, die in der Titelleiste eines umgewndelten
  126.        Fensters noch angezeigt werden. Voreingestellt sind 12 Buchstaben.
  127.        Die Tiefensteller sind dabei nicht eingerechnet (wurde
  128.        DEPTHGADGETS=TRUE gewählt, ist das Fenster breiter).
  129.  
  130.      -d | -!d
  131.      DEPTHGADGETS=boolean
  132.        Hier bestimmt man, ob die umgewandelten Fenster Tiefensteller
  133.        besitzen (benötigt bis zu 50 Pixeln). Voreinstellung ist TRUE (-d).
  134.        Ist STICKY=TRUE, dann ist notwendigerweise DEPTHGADGETS=FALSE, da
  135.        andernfalls die Wicons (umgewandelte Fenster) verschwinden würden.
  136.  
  137.      -f | -!f
  138.      FIRSTSCREEN=boolean
  139.        Anstatt die WorkBench als Wicon-Bildschirm zu benutzen, solltest Du
  140.        eher FirstScreen benutzen, so daß Du nur den Bildschirm nach vorne
  141.        holen brauchst, auf den Wicon wirkt. Allerdings lautet die Vorein-
  142.        stellung FALSE (-!f).
  143.  
  144.      -i | -!i
  145.      ICONIFY=boolean
  146.        Hiermit legst Du fest, ob die Iconinfizier-Funktion überhaupt
  147.        funktionieren soll. Ein Ausschalten kann z.B. nützlich sein, wenn
  148.        Du lediglich den Rahmen-Effekt haben möchtest. Voreingestellt
  149.        ist EIN (-i). Zum Aussachlten gibst Du also -!i ein.
  150.  
  151.      -l number
  152.      LINES=short
  153.        Die Anzahl der Iconzeilen, die am unteren Rand aufgebaut werden soll.
  154.        Voreinstellung ist eins, was dazu führt, daß die Icons zunächst
  155.        die ganze untere Reihe ausfüllen und dann erst die nächste Reihe
  156.        anfangen. Ist Lines=0, dann bleiben die Icons, wo vorher die Fenster
  157.        waren.
  158.  
  159.      -p priority
  160.      PRIORITY=short
  161.        Ändert die Task-Priorität. Ich kann mir aber nicht vorstellen, was
  162.        das für einen Unterschied machen würde (und es macht auch keinen).
  163.        Voreingestellt ist (-p+0), was zu keiner Änderung führt.
  164.  
  165.      -q | -!q
  166.      QUIET=boolean
  167.        Liefert das den Wert TRUE, dann wird die Copyright-Nachricht nicht
  168.        mit ausgegeben. Voreinstellung: EIN (-q).
  169.  
  170.      -r | -!r
  171.      RMBTRAP=boolean
  172.        Wird dies auf TRUE gesetzt, dann werden auch diejenigen Fenster
  173.        umgewandelt, die mittels RMBTRAP auf ein Klicken der rechten
  174.        Maustaste warten. Hier ist FALSE (-!r) vorgegeben.
  175.  
  176.      -s | -!s
  177.      STICKY=booelan
  178.       Mit diesem Parameter bestimmt man, ob sich das umgewandelte Fenster
  179.       wie ein richtiges Icon verhält, indem es auf dem Workbench-Bildschirm
  180.       "klebt" und nicht auf anderen fenstern, die seine Position überdecken,
  181.       abgebildet wird. Hier ist FALSE (-!s) eingestellt.
  182.       In dieser Betriebsart sind die Tiefensteller ausgeschaltet, so daß
  183.       Du die Icons auch nicht mehr unter andere Fenster setzen kannst.
  184.  
  185.      -t | -!t
  186.      TESTING=boolean
  187.        Diese einstellung führt lediglich zum Test von MacWin, indem ein
  188.        Fenster geöffnet und wieder geschlossen wird. Voreinstellung ist
  189.        hier natürlich FALSE.
  190.  
  191.      -W string
  192.      WINDOW=string
  193.        Sobald ein "Tool Type parsing error" auftaucht, wird ein auf dem
  194.        Aztec-C-Compiler basierendes (aber völlig davon unabhängiges)
  195.        Fenster geöffnet.
  196.        Als Fenster ist voreingestellt: "CON:0/0/640/100/Error Window".
  197.        Man beachte das großgeschriebene "W". Im CLI wirkt das allerdings
  198.        nicht.
  199.  
  200.      -w | -!w
  201.      WBWINDOWS=boolean
  202.        Ist dies TRUE, dann können auch Workbench-fenster wie z.B. Drawers
  203.        (Unterverzeichnisse) umgewandelt werden. Voreingestellt ist
  204.        FALSE (-!w).
  205.  
  206.  
  207.     Eine Liste der Voreinstellungen erhältst Du durch Eingabe von
  208.     "wicon ?" oder "wicon \?" im CLI.
  209.  
  210. DATEIEN
  211.      Wicon.info     - ja, ebenfalls eingebaut; alle drei Zeilen!
  212.  
  213. PROGRAMMFEHLER
  214.      Nur wenige Programme können sich nicht mit Wicon anfreunden. Die
  215.      meisten davon erzeugen lustige Effekte, wie z.B. die Preferences,
  216.      das wie allen anderen Fenster, die die Funktion WBENCHWINDOW->WScreen
  217.      benutzen. Aber Hauptsache, Du magst das Programm.
  218.  
  219.      Ein Freund von mir hatte auch Probleme mit seiner Version von mclk,
  220.      das meinere Ansicht nach mit Timing-Problemen zusammenhängt.
  221.  
  222.      Ein wirklicher Fehler tritt nur gelegentlich (zweimal in 5 Monaten)
  223.      auf, indem beim Schließen eines Fensters der Rahmen zunächst größer
  224.      um das Fenster gezeichnet wird. Keine Ahnung, woran das liegt.
  225.  
  226.      Die Wicons beinhalten auch die Fenster- und Bildschirmtitel des
  227.      Originalfensters. Ändern sich diese, dann merkt wicon nichts davon.
  228.      Das ist mir zwar noch nie passiert, aber sollte es Dir einmal
  229.      passieren, dann schmeiß das blöde Programm raus.
  230.  
  231.      Nimm Dich auch in acht vor Programmen, die SetFunction() benutzen,
  232.      wie insbesondere mwb. Beim Beenden derartiger Programme werden
  233.      nämlich alle Vektoren wieder in ihren Originalzustand versetzt.
  234.      In dem Falle ist Wicon desaktiviert, bis die entsprechenden Vektoren
  235.      wiederhergestellt sind (siehe auch UnSetFunction(3) ).
  236.  
  237. SIEHE AUCH
  238.      OpenWindow(3), CloseWindow(3), GetDiskObject(3).
  239.  
  240. AUTOR
  241.      Steven Sweeting 24. April 1988
  242.  
  243.      Wenn Du dieses Programm magst, dann schicke mir bitte eine Postkarte:
  244.  
  245.        Steven Sweeting      FAX  +61 2 772-2713
  246.        442 Willarong Rd,
  247.        Caringbah 2229
  248.        NSW, Australia.
  249.  
  250.      ACSNET/CSNET: steven@kylie.oz.AU ARPA: steven%kylie.oz.AU@UUNET.UU.NET
  251.      UUCP: {uunet,hplabs,mcvax,ukc,nttlab}!munnari!kylie.oz!steven
  252.  
  253.      Wenn Du mir 10 Australische Dollar zuschickst, dann erhältst Du
  254.      eine Diskette mit den neusten von mir verfaßten PD-Programmen.
  255.      Bitte gib dazu Dein Aufzeichnungsformat inklusive Versionsnummer an.
  256.  
  257.      Vielen dank auch an Andrew Smith, der mit mir die Methode zum
  258.      Iconifizieren ausgearbeitet hat, und an Tim Edgoose, der mir LINES
  259.      vorgeschlagen hat.
  260.  
  261. VERTRIEB
  262.      Dieses Programm ist KEIN Public Domain. Die Weitergabe von Quellcode
  263.      und Programm (als ganzes) zu kommerziellen Zwecken darf nur mit
  264.      Zustimmung des Autors erfolgen. Programmteile dürfen mit Ausnahme
  265.      des File Handlers beliebig in eigene Programme eingebaut werden.
  266.  
  267.      Das Programm darf nur zusammen mit diesem Text weitergegeben werden.
  268.  
  269.      Es gibt keine Garantie dafür, daß dieses Programm nicht einen Virus
  270.      in einem verborgenen Teil einer bestimmten Festplatte ablegt, je nach
  271.      Lust und Laune die Systemzeit zurücksetzt, seine Priorität auf +127
  272.      setzt und lange wartezeiten verursacht oder auch ganz einfach nur
  273.      einen schlimmen GURU verursacht.
  274.  
  275.      Irgendeine Übereinstimmung dieses Programmes mit lebenden oder toten
  276.      Betriebssystemen wäre rein zufällig (besonders die Ähnlichkeit zum
  277.      Mac).
  278.  
  279.      Teile dieses Programmes unterliegen sind Copyright 1987 von
  280.      Davide P. Cervone (der Input Handler).
  281.  
  282. .MEIN TRAUM
  283.      Ein Programm mit mehr Optionen als ls (UNIX) zu schreiben!
  284.  
  285. .MEIN PLAN
  286.      Ein Programm mit mehr Optionen als acsstate zu schreiben!
  287.  
  288. ZUKUNFTSPERSPEKTIVEN
  289.     Wenn es mir möglich ist, dann möchte ich Icons einbeziehen, die beim
  290.     Anklicken ihre Gestalt wechseln und Icons, die ihre Grafik selbst auf
  291.     den neusten Stand bringen. Auch Schließsymbole und anderes sollte mir
  292.     durch linken der IDCMP-Ports möglich sein. Bitte schreibt doch mal
  293.     Programme die sich (mittels RMBTRAP) bei Anklicken mit der rechten
  294.     Maustaste selbst zum Icon wandeln wie z.B. AmigaP oder DME.
  295.  
  296. ANMERKUNGEN
  297.      Hey, CLI-Programmierer! Es gibt keine Entschuldigung dafür, dieses
  298.      Programm einfach wegzuwerfen! Bevor ihr das macht, schaut Euch doch
  299.      mal GetTools() an, das die Tool-Typen zu (argc-1,argv-1) umwandelt.
  300.      Auch die UnSetFunction() dürfte interessant sein, da sie auf jeden
  301.      Fall in eigene Programme eingebaut werden sollte, die SetFunction()
  302.      benutzen.
  303.  
  304.      Obwohl MacWin sehr sicher ist, bitte ich darum, es nicht in kommer-
  305.      ziellen Programmen zu benutzen, da das Ärger förmlich herbeibeschwört.
  306.      Ich selbst habe allerdings nur 2 Programme gefunden, die sich nicht
  307.      damit vertragen; nämlich clk2 und The yellow sub BADGE demo.
  308.      Trotzdem glaube ich, daß viele andere Programme ebenfalls nicht
  309.      damit zusammenarbeiten.
  310.  
  311.  
  312. REVISION 1.14       Zuletzt geändert am 24. April 1988       (c) 1988
  313.  
  314.